arrify

What is arrify?

The arrify npm package is designed to convert a value to an array. If the input value is already an array, it is returned as is. If the input is null or undefined, an empty array is returned. For any other input, the value is placed as a single item within an array. This package is particularly useful for ensuring that data is in array form without having to write repetitive checks and conversions throughout your code.

What are arrify's main functionalities?

Converting non-array values to an array

This feature demonstrates how to convert various types of non-array values (like strings or numbers) into an array containing that value.

const arrify = require('arrify');

console.log(arrify('hello')); // ['hello']
console.log(arrify(5)); // [5]

Handling null or undefined values

This feature shows how arrify converts null or undefined inputs into an empty array, which is useful for avoiding errors when working with potentially null or undefined data.

const arrify = require('arrify');

console.log(arrify(null)); // []
console.log(arrify(undefined)); // []

Preserving array inputs

This feature illustrates that arrify will return the input as is if it's already an array, ensuring that array inputs are not modified or wrapped in another array.

const arrify = require('arrify');

console.log(arrify(['already', 'an', 'array'])); // ['already', 'an', 'array']

Other packages similar to arrify

to-array

Similar to arrify, the to-array package converts various types of values into arrays. However, it might handle certain edge cases differently or offer additional features for converting objects into arrays.

arrayify

The arrayify package offers functionality similar to arrify, aiming to ensure that inputs are returned as arrays. The differences may lie in specific implementation details or additional options for handling complex data types.

README

arrify

Convert a value to an array

Install

$ npm install arrify

Usage

const arrify = require('arrify');

arrify('🦄');
//=> ['🦄']

arrify(['🦄']);
//=> ['🦄']

arrify(new Set(['🦄']));
//=> ['🦄']

arrify(null);
//=> []

arrify(undefined);
//=> []

Supplying null or undefined results in an empty array.

License

MIT © Sindre Sorhus